home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / all.z / all
Encoding:
Text File  |  2002-10-03  |  3.9 KB  |  98 lines

  1. ALL(3I)                                               Last changed: 4-13-99
  2.  
  3.  
  4. NNAAMMEE
  5.      AALLLL - Determines whether all values are true
  6.  
  7. SSYYNNOOPPSSIISS
  8.      AALLLL (([MMAASSKK==]_m_a_s_k [,,[DDIIMM==]_d_i_m]))
  9.  
  10. IIMMPPLLEEMMEENNTTAATTIIOONN
  11.      UNICOS, UNICOS/mk, IRIX systems
  12.  
  13.      CF90, MIPSpro 7 Fortran 90
  14.  
  15. SSTTAANNDDAARRDDSS
  16.      Fortran
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.      The AALLLL intrinsic function determines whether all values are true in
  20.      _m_a_s_k along dimension _d_i_m.  It accepts the following arguments:
  21.  
  22.      _m_a_s_k      Must be of type logical.  It must not be a scalar.
  23.  
  24.      _d_i_m       Must be a scalar.  It must be an integer value in the range
  25.                1 <= _d_i_m <= _n, where _n is the rank of _m_a_s_k.  The
  26.                corresponding actual argument must not be an optional dummy
  27.                argument.
  28.  
  29.      AALLLL is a transformational function.  The name of this intrinsic cannot
  30.      be passed as an argument.
  31.  
  32. RREETTUURRNN VVAALLUUEESS
  33.      The result is type logical.  It is a scalar result if _d_i_m is absent or
  34.      if _m_a_s_k has rank one.  Otherwise, the result is an array of rank _n-1
  35.      and of shape (_d , _d , ..., _d     , _d     , ..., _d ),
  36.                     1   2        _d_i_m-1   _d_i_m+1        _n
  37.      where (_d , _d , ..., _d )
  38.              1   2        _n
  39.      is the shape of _m_a_s_k.
  40.  
  41.      The result of AALLLL((_m_a_s_k)) has the value TTRRUUEE if all the elements of _m_a_s_k
  42.      are TTRRUUEE or if _m_a_s_k is a zero-sized array.  The result has the value
  43.      FFAALLSSEE if any element of _m_a_s_k is FFAALLSSEE.
  44.  
  45.      If _m_a_s_k has rank one, AALLLL((_m_a_s_k,, _d_i_m)) has a value equal to that of
  46.      AALLLL((_m_a_s_k)).  Otherwise, the value of
  47.      element (_s , _s , ..., _s     , _s     , ..., _s )
  48.                1   2        _d_i_m-1   _d_i_m+1        _n
  49.      of AALLLL((_m_a_s_k,, _d_i_m)) is equal to
  50.      AALLLL((_m_a_s_k (_s , _s , ..., _s     , : , _s     , ..., _s )).
  51.                 1   2        _d_i_m-1       _d_i_m+1        _n
  52.  
  53. EEXXAAMMPPLLEESS
  54.      Example 1:
  55.  
  56.      * AALLLL (( ((// ..TTRRUUEE..,, ..FFAALLSSEE..,, ..TTRRUUEE.. //)) )) is false.
  57.  
  58.      * AALLLL((_a_r_r_a_y)) is ..TTRRUUEE.. when _a_r_r_a_y is a zero-sized array.
  59.  
  60.      Example 2:  Assume that BB and CC are arrays as follows:
  61.  
  62.      BB is the following array:
  63.  
  64.      | 1 3 5 |
  65.      | 2 4 6 |
  66.  
  67.      CC is the following array:
  68.  
  69.      | 0 3 5 |
  70.      | 7 4 8 |
  71.  
  72.      * AALLLL (( BB ..NNEE.. CC )) is ..FFAALLSSEE..
  73.  
  74.      * AALLLL (( BB ..NNEE.. CC,, DDIIMM==11)) is [[..TTRRUUEE..,, ..FFAALLSSEE..,, ..FFAALLSSEE..]]
  75.  
  76.      * AALLLL (( BB ..NNEE.. CC,, DDIIMM==22)) is [[..FFAALLSSEE..,, ..FFAALLSSEE..]]
  77.  
  78.      * AALLLL (( BB ..NNEE.. 11 )) is ..FFAALLSSEE.. because there is one false element in
  79.        the mask.
  80.  
  81.      Example 3:  Assume that array NN is as follows:
  82.  
  83.      | 0 1 2 3 |
  84.      | 4 5 6 7 |
  85.      | 8 9 0 1 |
  86.  
  87.      In an array section reference, you can expect the following results:
  88.  
  89.      * AALLLL((((NN((22::33,,22::44))..NNEE..00)))) is ..FFAALLSSEE..
  90.  
  91.      * AALLLL((((NN((22::33,,22::44))..NNEE..00)),,DDIIMM==11)) is [[..TTRRUUEE..,, ..FFAALLSSEE..,, ..TTRRUUEE..]]
  92.  
  93.      * AALLLL((((NN((22::33,,22::44))..NNEE..00)),,DDIIMM==22)) is [[..TTRRUUEE..,, ..FFAALLSSEE..]]
  94.  
  95. SSEEEE AALLSSOO
  96.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed version of this
  97.      man page.
  98.